home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / 3d_tools / irit40s.lha / Irit / readme.1st < prev    next >
Encoding:
Text File  |  1994-01-05  |  10.6 KB  |  230 lines
  1. This file describes the steps need to be taken to compile this package
  2. under the different environments.
  3.  
  4. Join IRIT mailing list:        gershon@cs.technion.ac.il
  5. Mailing list:            irit-mail@cs.technion.ac.il
  6. Bug reports:            irit-bugs@cs.technion.ac.il
  7.  
  8. -----------------------------------------------------------------------------
  9.  
  10. OS2
  11. ---
  12.  
  13.    Edit the file makeflag.os2 in the main directory.
  14. Set all the variables to the correct path you would like the include
  15. files/libraries/binaries to be installed to.
  16.    Type 'make -f makefile.os2'. This should build the libraries
  17. (misc/cagd/prsr/graf) following by all the tools including the solid
  18. modeler itself - IRIT.
  19.  
  20.    Once everything built, change directory to the binaries directory. Edit
  21. all *.cfg configuration files and follow the instructions in them to configure
  22. the programs to your system.
  23.    On line help is saved in irit.hlp and is copied to the binaries
  24. directory. In the docs directories, the 'irit.tex' can be latex'ed and printed
  25. to get a hardcopy manual for IRIT. Alternatively print 'irit.doc' which is
  26. a similar but plain text file.
  27.  
  28.    Each of the subdirectories illustrt/iritfltr/poly3d-r/poly3d-h has a
  29. batch file called test-os2.cmd. Run them to test your new executables.
  30.   Note you will need a gif viewer for poly3d-r images and that test-os2.cmd on
  31. poly3d-h do require ???Drvs display device executable to display the hidden
  32. line removed results.
  33. On the IRIT subdirectory type 'irit demo.irt' to run a demo of IRIT.
  34. There are quite a few other .irt files in that directory you may want to try.
  35. Make sure the IRIT_PATH environment variable is properly set as well as
  36. OS2IRIT and OS2IRIT_POS as described in the manual. You can run all
  37. these tests by executing 'make -f makefile.os2 test' from the main directory.
  38.  
  39.    Things to watch for:
  40.  
  41. * all the makefiles in the subdirectories source makeflag.unx via the line
  42.   'include ../makeflag.os2'. If your make support different include structure
  43.   or does not support it at all, you will have to change it or manually
  44.   substitute makeflag.unx content into the subdirectory makefiles.
  45. * poly3d-r requires gif_lib (see below) to build, a library that is not
  46.   provided with this package. You can ftp it separately (see below).
  47.   The poly3d-r renderer renders into 8 bit GIF images and results are
  48.   medium at best. Using the filter IRIT2RAY, use RAYSHADE which is far
  49.   superior and recommended.
  50.  
  51. -----------------------------------------------------------------------------
  52.  
  53. UNIX
  54. ----
  55.    Edit the file makeflag.unx in the main directory.
  56. Set all the variables to the correct path you would like the include
  57. files/libraries/binaries to be installed to.
  58. Select the correct compiler flags if your architecture exists there.
  59. Otherwise create a new entry for these flags for your system.
  60.    Type 'make -f makefile.unx'. This should build the libraries
  61. (misc/cagd/prsr/graf) following by all the tools including the solid
  62. modeler itself - IRIT.
  63.  
  64.    Once everything built, change directory to the binaries directory. Edit
  65. all *.cfg configuration files and follow the instructions in them to configure
  66. the programs to your system.
  67.    On line help is saved in irit.hlp and is copied to the binaries
  68. directory. In the docs directories, the 'irit.tex' can be latex'ed and printed
  69. to get a hardcopy manual for IRIT. Alternatively print 'irit.doc' which is
  70. a similar but plain text file.
  71.  
  72.    Each of the subdirectories illustrt/iritfltr/poly3d-r/poly3d-h has a batch
  73. file called test-unx. Run them to test your new executables by doing
  74. 'csh test-unx'. Note you will need a gif viewer for poly3d-r images and that
  75. test-unx on poly3d-h do require ???drvs display device executable to display
  76. the hidden line removed results.
  77. On the IRIT subdirectory type 'irit demo.irt' to run a demo of IRIT.
  78. There are quite a few other .irt files in that directory you may want to try.
  79. Make sure the IRIT_PATH and IRIT_DISPLAY environment variables are properly
  80. set as described in the manual. You can run all these tests by executing
  81. 'make -f makefile.unx test' from the main directory. Optionally you might
  82. need to set the environment of IRIT_SERVER_PORT and IRIT_SERVER_HOST.
  83.  
  84.    Things to watch for:
  85.  
  86. * all the makefiles in the subdirectories source makeflag.unx via the line
  87.   'include ../makeflag.unx'. If your make support different include structure
  88.   or does not support it at all, you will have to change it or manually
  89.   substitute makeflag.unx content into the subdirectory makefiles.
  90. * Your system must support either X11 or gl. Without graphics you would not
  91.   be able to build most of the tools, including IRIT itself.
  92. * poly3d-r is NOT building under UNIX by default. This is because you need
  93.   another library called gif_lib to link to, and which is not
  94.   provided with this package. You can ftp it separately (see below).
  95.   The poly3d-r renderer renders into 8 bit GIF images and results are
  96.   medium at best. Using the filter IRIT2RAY, use RAYSHADE which is far
  97.   superior and recommended.
  98.  
  99. -----------------------------------------------------------------------------
  100.  
  101. AMIGADOS
  102. --------
  103.  
  104. The Amiga port of Irit requires SAS/C or gcc, versions 6.3 and 2.4.5 or later,
  105. respectively. Do not use the optimizer with either compiler.
  106.  
  107. Building with SAS/C:
  108.  
  109. Edit makeflag.sas, and modify the following assignments:
  110. SRC_DIR =    Put here the name of the top level irit directory.
  111. DFLAGS =    Modify the DEFINE=M68881 directive according to what kind of
  112.         floating point math you want. Use DEFINE=M68881 if you have an
  113.         FPU (68881/68882/68040), DEFINE=MIEEE if you want to use the
  114.         IEEE math libraries, or MFFP if you want to use Motorolla fast
  115.         floating point math. (I've no idea if this last one will work!)
  116.         This definition controls which of the three include files,
  117.         <m68881.h>, <mieeedoub.h> or <mffp.h> will be included after
  118.         <math.h>.
  119. CFLAGS =    Modify the CPU= and MATH= options according to what CPU you
  120.         have and what kind of floating point math you want to use. Do
  121.         not be tempted to add the OPTIMIZE flag here.
  122.  
  123. (You're going to hate me for this!)
  124. Since smake does not have an include directive, you'll now have to edit
  125. makefile.sas in the top level directory and in all subdirectories.
  126. Delete all lines between #-----'s and replace them with the contents of
  127. makeflag.sas. Alternatively, you can make the above changes in each
  128. makefile.sas.
  129.  
  130. Assuming you're still with me, type smake -f makefile.sas at the top directory,
  131. and go for a very large cup of coffee. When you return, all the binaries will
  132. be in the bin subdirectory.
  133.  
  134. Building with gcc:
  135.  
  136. Proceed as above, with the following differences:
  137.  
  138. The make flags are in makeflag.ami, and the makefiles are called makefile.ami.
  139. There are no DFLAGS to change, and in CFLAGS change the -m68040 and -m68881
  140. options to reflect your CPU and preferred floating point math type.
  141. After updating all makefiles (if you have a make with an include directive
  142. this updating should be much simpler), type make -f makefile.ami and take an
  143. even longer coffee break.
  144.  
  145. Differences between UNIX and Amiga Irit:
  146.  
  147. None to speak of. There is no IRIT_SERVER_HOST environment variable, and
  148. IRIT_SERVER_PORT points to the name of an Exec port rather than to whatever it
  149. is that it points to in UNIX. If amidrvs is in your path, you do not have to
  150. set IRIT_DISPLAY, as irit will use "amidrvs -s-" by default. If for some
  151. reason you have to/ want to run amidrvs by hand, be sure to run it after irit
  152. starts looking for it. Yes, I know that the synchronization code between irit
  153. and amidrvs is an awful kludge, but since it works, I'm in no particular hurry
  154. to fix it.
  155.  
  156. Bugs:
  157. Quitting from amidrvs while Irit is running, will cause Irit to hang.
  158.  
  159. Bug reports:
  160. If you think you've found a bug in the Amiga port (as opposed to a bug in irit
  161. itself), send mail to kyrimis@theseas.ntua.gr.
  162.  
  163. -----------------------------------------------------------------------------
  164.  
  165. WINDOWS NT
  166. ----------
  167.  
  168.    Edit the file makeflag.wnt in the main directory.
  169. Set all the variables to the correct path you would like the include
  170. files/libraries/binaries to be installed to.
  171.    Type 'nmake -f makefile.wnt' (namke is Microsoft's make provided with
  172. the SDK of Window NT 3.1). This should build the libraries
  173. (misc/cagd/prsr/graf) following by all the tools including the solid
  174. modeler itself - IRIT.
  175.  
  176.    Once everything built, change directory to the binaries directory. Edit
  177. all *.cfg configuration files and follow the instructions in them to configure
  178. the programs to your system.
  179.    On line help is saved in irit.hlp and is copied to the binaries
  180. directory. In the docs directories, the 'irit.tex' can be latex'ed and printed
  181. to get a hardcopy manual for IRIT. Alternatively print 'irit.doc' which is
  182. a similar but plain text file.
  183.  
  184.    Each of the subdirectories illustrt/iritfltr/poly3d-r/poly3d-h has a batch
  185. file called test-os2.cmd. Run them to test your new executables.
  186.    Note you will need a gif viewer for poly3d-r images and that test-os2.cmd on
  187. poly3d-h do require ???drvs display device executable to display the hidden
  188. line removed results.
  189. On the IRIT subdirectory type 'irit demo.irt' to run a demo of IRIT.
  190. There are quite a few other .irt files in that directory you may want to try.
  191. Make sure the IRIT_PATH environment variable is properly set as well as
  192. IRIT_DISPLAY. Optional are IRIT_SERVER_HOST and IRIT_SERVER_PORT as described
  193. in the manual.
  194. You can run all these tests by executing 'make -f makefile.os2 test' from
  195. the main directory.
  196.  
  197.    Things to watch for:
  198.  
  199. * all the makefiles in the subdirectories source makeflag.unx via the line
  200.   'include ../makeflag.os2'. If your make support different include structure
  201.   or does not support it at all, you will have to change it or manually
  202.   substitute makeflag.unx content into the subdirectory makefiles.
  203. * poly3d-r requires gif_lib (see below) to build, a library that is not
  204.   provided with this package. You can ftp it separately (see below).
  205.   The poly3d-r renderer renders into 8 bit GIF images and results are
  206.   medium at best. Using the filter IRIT2RAY, use RAYSHADE which is far
  207.   superior and recommended.
  208.  
  209. -----------------------------------------------------------------------------
  210.  
  211. The intr_lib sources can be ftped from the following two places:
  212.  
  213. 1. wuarchive.wustl.edu. directory mirrors/msdos/irit/intrlib?.zip
  214. 2. simtel20.arpa.mil, directory PD:<MSDOS.IRIT> as intrlib?.zip
  215. where ? is the current version.
  216.  
  217. libintr.a (DJGPP) and intr_lib.lib (MSDOS) are built from this package.
  218.  
  219. -----------------------------------------------------------------------------
  220.  
  221. The gif_lib sources can be ftped from the following two places:
  222.  
  223. 1. wuarchive.wustl.edu. directory mirrors/msdos/gif/giflib??.zip
  224. 2. simtel20.arpa.mil, directory PD:<MSDOS.GIF> as giflib??.zip
  225. where ?? is the current version.
  226.  
  227. libgif.a (UNIX) and gif_libl.lib (MSDOS) are built from the lib subdirectory
  228. of giflib??.zip package.
  229.  
  230.